From 8195244e3bb1c53204e5a4d18b249634e713b2fa Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Thu, 6 Mar 2014 22:50:40 -0500 Subject: [PATCH] Improve GtkStack documentation As has been pointed out in https://bugzilla.gnome.org/show_bug.cgi?id=725711 it is a little confusing that we have the concept of a visible child and of the child being visible itself. --- gtk/gtkstack.c | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/gtk/gtkstack.c b/gtk/gtkstack.c index 6d3a57a407..3b338be7a2 100644 --- a/gtk/gtkstack.c +++ b/gtk/gtkstack.c @@ -1392,6 +1392,10 @@ gtk_stack_get_visible_child_name (GtkStack *stack) * two will be animated with the current * transition type of @stack. * + * Note that the @child widget has to be visible itself + * (see gtk_widget_show()) in order to become the visible + * child of @stack. + * * Since: 3.10 */ void @@ -1430,6 +1434,10 @@ gtk_stack_set_visible_child (GtkStack *stack, * two will be animated with the current * transition type of @stack. * + * Note that the child widget has to be visible itself + * (see gtk_widget_show()) in order to become the visible + * child of @stack. + * * Since: 3.10 */ void @@ -1449,6 +1457,10 @@ gtk_stack_set_visible_child_name (GtkStack *stack, * * Makes the child with the given name visible. * + * Note that the child widget has to be visible itself + * (see gtk_widget_show()) in order to become the visible + * child of @stack. + * * Since: 3.10 */ void -- 2.30.2